home *** CD-ROM | disk | FTP | other *** search
eeeexxxxppppllllaaaaiiiinnnn((((1111)))) eeeexxxxppppllllaaaaiiiinnnn((((1111)))) NNNNAAAAMMMMEEEE explain - displays the explanation for an error message SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS _eeee_xxxx_pppp_llll_aaaa_iiii_nnnn _m_s_g_i_d DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN The _eeee_xxxx_pppp_llll_aaaa_iiii_nnnn utility retrieves and outputs a message explanation from an online explanation catalog. If the output device is a terminal, the output of _eeee_xxxx_pppp_llll_aaaa_iiii_nnnn is piped through the pager specified in the _PPPP_AAAA_GGGG_EEEE_RRRR variable. If _PPPP_AAAA_GGGG_EEEE_RRRR is not specified, the default pager _mmmm_oooo_rrrr_eeee _----_ssss is used. If the output device is not a terminal, the output of _eeee_xxxx_pppp_llll_aaaa_iiii_nnnn is sent to the standard output device (_ssss_tttt_dddd_oooo_uuuu_tttt). The _eeee_xxxx_pppp_llll_aaaa_iiii_nnnn command requires the following argument: _m_s_g_i_d Specifies the message ID string associated with a message that appears when an error message is output. This string consists of the product group code and the message number. The product group code (_g_r_o_u_p) is a string that identifies the product issuing the message. The message number (_m_s_g#) specifies which message within the product you have received. Enter the message ID as an argument to _eeee_xxxx_pppp_llll_aaaa_iiii_nnnn in the form _g_r_o_u_p_m_s_g# or in the form _g_r_o_u_p- _m_s_g#. If the group code ends in one or more digits (for example, _cccc_ffff_9999_0000), you must use the form that includes the dash (_----). RRRReeeeccccooooggggnnnniiiizzzzeeeedddd GGGGrrrroooouuuupppp CCCCooooddddeeeessss The following tables show the products and group codes that have message and explanation catalogs on IRIX systems. The first column lists the group code (needed to look up the explanations for messages); the second column gives the complete name of the software product or products associated with the group code. Group Code Software Product _aaaa_cccc_cccc_tttt Comprehensive System Accounting (CSA) _cccc_ffff_9999_0000 _ffff_9999_0000 version 7.2 _dddd_mmmm Data Migration Facility _llll_iiii_bbbb Fortran 90 library version 2.0, and _llll_iiii_bbbb_ffff_ffff_iiii_oooo _mmmm_ssss_gggg_ssss_yyyy_ssss _eeee_xxxx_pppp_llll_aaaa_iiii_nnnn(1) and _cccc_aaaa_tttt_eeee_rrrr_rrrr(1) utilities _nnnn_qqqq_ssss Network Queuing System LLLLooooccccaaaattttiiiioooonnnn ooooffff EEEExxxxppppllllaaaannnnaaaattttiiiioooonnnn CCCCaaaattttaaaallllooooggggssss To find the explanation for the message, _eeee_xxxx_pppp_llll_aaaa_iiii_nnnn searches the path specified in the _NNNN_LLLL_SSSS_PPPP_AAAA_TTTT_HHHH environment variable for the _g_r_o_u_p_...._eeee_xxxx_pppp file. The value of the _NNNN_LLLL_SSSS_PPPP_AAAA_TTTT_HHHH variable depends on the _LLLL_AAAA_NNNN_GGGG environment variable or the _LLLL_CCCC______MMMM_EEEE_SSSS_SSSS_AAAA_GGGG_EEEE_SSSS category. If _eeee_xxxx_pppp_llll_aaaa_iiii_nnnn cannot access an existing explanation catalog, check the value of the _NNNN_LLLL_SSSS_PPPP_AAAA_TTTT_HHHH environment variable and either the _LLLL_AAAA_NNNN_GGGG environment variable or the _LLLL_CCCC______MMMM_EEEE_SSSS_SSSS_AAAA_GGGG_EEEE_SSSS category to ensure that the pathname of the catalog is in the message system search path. PPPPaaaaggggeeee 1111 eeeexxxxppppllllaaaaiiiinnnn((((1111)))) eeeexxxxppppllllaaaaiiiinnnn((((1111)))) See _eeee_nnnn_vvvv_iiii_rrrr_oooo_nnnn(5) for a description of the _NNNN_LLLL_SSSS_PPPP_AAAA_TTTT_HHHH, _LLLL_AAAA_NNNN_GGGG, and _LLLL_CCCC______MMMM_EEEE_SSSS_SSSS_AAAA_GGGG_EEEE_SSSS components. MMMMeeeessssssssaaaaggggeeee FFFFoooorrrrmmmmaaaatttt VVVVaaaarrrriiiiaaaabbbblllleeeessss If _m_s_g_i_d does not appear with the error message or if you want to change the format of the messages you receive, you can modify your _MMMM_SSSS_GGGG______FFFF_OOOO_RRRR_MMMM_AAAA_TTTT and _CCCC_MMMM_DDDD_MMMM_SSSS_GGGG______FFFF_OOOO_RRRR_MMMM_AAAA_TTTT environment variables. Both variables can be set to define the fields and the order of the fields to be included in message output. The _MMMM_SSSS_GGGG______FFFF_OOOO_RRRR_MMMM_AAAA_TTTT variable controls the format in which you receive error messages from programs that use the message formatting function _cccc_aaaa_tttt_mmmm_ssss_gggg_ffff_mmmm_tttt(3C). These are most messages in group codes other than _mmmm_ssss_gggg_ssss_yyyy_ssss. The _eeee_xxxx_pppp_llll_aaaa_iiii_nnnn and _cccc_aaaa_tttt_eeee_rrrr_rrrr utilities use either _CCCC_MMMM_DDDD_MMMM_SSSS_GGGG______FFFF_OOOO_RRRR_MMMM_AAAA_TTTT or _MMMM_SSSS_GGGG______FFFF_OOOO_RRRR_MMMM_AAAA_TTTT variables; however, _CCCC_MMMM_DDDD_MMMM_SSSS_GGGG______FFFF_OOOO_RRRR_MMMM_AAAA_TTTT is used before _MMMM_SSSS_GGGG______FFFF_OOOO_RRRR_MMMM_AAAA_TTTT. MMMMeeeessssssssaaaaggggeeee FFFFoooorrrrmmmmaaaatttt SSSSyyyynnnnttttaaaaxxxx Valid fields for _MMMM_SSSS_GGGG______FFFF_OOOO_RRRR_MMMM_AAAA_TTTT and _CCCC_MMMM_DDDD_MMMM_SSSS_GGGG______FFFF_OOOO_RRRR_MMMM_AAAA_TTTT are as follows: _%%%%_GGGG Group code _%%%%_NNNN Message number _%%%%_CCCC Command name _%%%%_SSSS Severity level _%%%%_PPPP Position of the error _%%%%_MMMM Message text _%%%%_DDDD Debugging information _%%%%_TTTT Time stamp If one of the _%%%% fields is not present in the contents of _MMMM_SSSS_GGGG______FFFF_OOOO_RRRR_MMMM_AAAA_TTTT or _CCCC_MMMM_DDDD_MMMM_SSSS_GGGG______FFFF_OOOO_RRRR_MMMM_AAAA_TTTT, the corresponding message field is not printed. The default message format is produced by the following assumed _MMMM_SSSS_GGGG______FFFF_OOOO_RRRR_MMMM_AAAA_TTTT contents: %G-%N %C: %S %P\n %M\n For messages issued by the IRIX utilities _eeee_xxxx_pppp_llll_aaaa_iiii_nnnn(1) and _cccc_aaaa_tttt_eeee_rrrr_rrrr(1), the default message format is produced by the following assumed _CCCC_MMMM_DDDD_MMMM_SSSS_GGGG______FFFF_OOOO_RRRR_MMMM_AAAA_TTTT contents: %G-%N: %C %M\n PPPPaaaaggggeeee 2222 eeeexxxxppppllllaaaaiiiinnnn((((1111)))) eeeexxxxppppllllaaaaiiiinnnn((((1111)))) Messages issued from the _cccc_mmmm_dddd group code determine their format according to the following precedence: 1 Content of _CCCC_MMMM_DDDD_MMMM_SSSS_GGGG______FFFF_OOOO_RRRR_MMMM_AAAA_TTTT variable, if it exists 1 Content of _MMMM_SSSS_GGGG______FFFF_OOOO_RRRR_MMMM_AAAA_TTTT variable, if it exists 1 Default message format for utilities The format of the time stamp (_%%%%_TTTT) is equivalent to that produced by the _cccc_ffff_tttt_iiii_mmmm_eeee(3C) function and can be overridden by the _CCCC_FFFF_TTTT_IIII_MMMM_EEEE environment variable. For details about time stamp formats, see the _ssss_tttt_rrrr_ffff_tttt_iiii_mmmm_eeee(3C) man page, which documents the _cccc_ffff_tttt_iiii_mmmm_eeee function. The Standard C _pppp_rrrr_iiii_nnnn_tttt_ffff escape sequences also can be embedded in the contents of _MMMM_SSSS_GGGG______FFFF_OOOO_RRRR_MMMM_AAAA_TTTT. The following table lists special characters that can be embedded. Description Symbol Sequence New-line char NL (LF) _\\\\_nnnn Horizontal tab HT _\\\\_tttt Vertical tab VT _\\\\_vvvv Backspace BS _\\\\_bbbb Carriage return CR _\\\\_rrrr Form feed FF _\\\\_ffff Audible alert BEL _\\\\_aaaa Backslash \ _\\\\_\\\\ Question mark ? _\\\\_???? Single quot. ' _\\\\_'''' Double quot. " _\\\\_"""" Octal number ooo _\\\\_o_o_o Hex. number hh _\\\\_xxxx_h_h The escape \_o_o_o consists of the backslash followed by 1, 2, or 3 octal digits, which are taken to specify the value of the desired character. A common example of this construction is _\\\\_0000 which specifies the null character. The escape _\\\\_xxxx_h_h consists of the backslash, followed by _xxxx, followed by hexadecimal digits, which are taken to specify the value of the desired character. There is no limit on the number of digits, but the behavior is undefined if the resulting character value exceeds that of the largest character. Any characters other than those listed in this table are passed through without the backslash, (for example, _\\\\_qqqq produces _qqqq). SSSSEEEEEEEE AAAALLLLSSSSOOOO caterr(1), gencat(1), catgetmsg(3C), catmsgfmt(3C), msg(7D). PPPPaaaaggggeeee 3333 
